home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / metering / xmeter / xmeter.doc next >
Text File  |  1996-07-10  |  8KB  |  215 lines
  1.     
  2.     Computer Tyme XMETER * Version 1.71 * Release Date: 07-01-93
  3.     Copyright 1990-93 by Marc Perkel * All Rights Reserved
  4.     
  5.     Computer Tyme * 411 North Sherman, Suite 300 * Springfield Mo. 65802
  6.     Voice: 417-866-1222 * Modem: 417-866-1665 * Fax: 417-866-0135 * USA
  7.      
  8.     This program is part of a utilities package. Before registering it
  9.     you might want to try out some of the other programs in the package.
  10.      
  11.     You can download these other programs from our BBS at 417-866-1665 or
  12.     from our section on Compuserve. (GO COMPTYME) If you have any questions
  13.     feel free to call us.
  14.      
  15.          ┌─────────────────────────────────────────────────────┐
  16.          │ Evaluation Version. This program is not registered. │
  17.          │    If you want to use it you need to buy a copy.    │
  18.          └─────────────────────────────────────────────────────┘
  19.      
  20.     Price: $95/Server, $995/Unlimited
  21.     
  22.     XMETER is a software metering program for Novell Networks. Its simple,
  23.     uses NO RAM, and does no require any VAPs or NLMs running on the server.
  24.     
  25.     XMETER uses Novells semaphores to monitor program usage. What you do is
  26.     create a BATCH file to load your software. You open a semaphore on the
  27.     way in and close it on the way out. The batch file must be programmed to
  28.     restrict access to the program. XMETER returns dos errorlevel codes to
  29.     control batch files.
  30.     
  31.     Usage: XMETER <Semaphore> <MaxUsers> /O/C/U/L/E/F
  32.     
  33.     Semaphore is any name you want to give a semaphore.
  34.     MaxUsers is the maximum number of users allowed to use the
  35.     semaphore or the name of a meter list file.
  36.     
  37.     /O Open semaphore.
  38.     /C Close semaphore.
  39.     /U Displays number of semaphore users.
  40.     /L Outputs status line for log file redirection.
  41.     /E Returns number of semaphore users as an error level.
  42.     /F:Name specifies log file name.
  43.     
  44.     A list file can be used to specify the maximum number of users
  45.     for each program. This list file contains lines as follows:
  46.     
  47.     WORDSTAR 10
  48.     LOTUS 5
  49.     DBASE 6
  50.     
  51.     Example: XMETER TEST 10 /O   
  52.       This opens semaphore TEST if less than 10 users have it open,
  53.       otherwise to returns DOS ErrorLevel 1.
  54.     
  55.     Example: XMETER TEST /C
  56.       This closes semaphore TEST allowing others to use it.
  57.     
  58.     Example: XMETER TEST METER.LST /O/L/F:USAGE.LOG
  59.       This opens semaphore TEST if less than the number of users
  60.       specified in METER.LST have it open, otherwise to returns
  61.       DOS ErrorLevel 1. Log information is appended to log file
  62.       named USAGE.LOG.
  63.     
  64.     Example BATCH file for WordStar limited to 12 users:
  65.     
  66.     @Echo Off
  67.     XMETER WORDSTAR 10 /O
  68.     if ErrorLevel 1 goto deny
  69.     
  70.     cd\wordstar
  71.     ws
  72.     
  73.     rem Close Semaphore when done.
  74.     
  75.     XMETER WORDSTAR /C
  76.     goto e
  77.     
  78.     :deny
  79.     cls
  80.     Echo Access Denied! All copies of WORDSTAR are in use.
  81.     
  82.     rem Exit Here
  83.     :e
  84.     
  85.     Using a meter list file:
  86.     ------------------------
  87.     XMETER can use a special text file to limit semaphore access. To use
  88.     this method, substitute the name of the list file for the MaxUsers
  89.     parameter as follows:
  90.     
  91.     XMETER Lotus METER.LST /O
  92.     
  93.     METER.LST
  94.     
  95.     Lotus 10
  96.     Wordstar 15
  97.     dBase 9
  98.     
  99.     This allows you to maintain the number of copies of each program in
  100.     a single list.
  101.     
  102.     
  103.     Usage Tracking:
  104.     ---------------
  105.     
  106.     XMETER provides usage tracking by outputing a comma delimited ascii line
  107.     for each semaphore open and close. You must select the /L switch to
  108.     activate this feature. IMPORTANT: Don't make USAGE.LOG sharable!
  109.     
  110.     Example: XMETER TEST METER.LST /O/L/F:USAGE.LOG
  111.     
  112.     This command appends the following line to the file USAGE.LOG.
  113.     
  114.     "MARC","LOTUS","3","O","Y","06-20-93","15:00:56","250:41","16"
  115.     
  116.     The line contains 9 fields as follows:
  117.     
  118.     1) User Name
  119.     2) Semaphore Name
  120.     3) Number of Semaphore users after execution
  121.     4) Command, O=Open C=Close
  122.     5) Success Status, Y=Success N=Failure
  123.     6) Date
  124.     7) Time
  125.     8) Internet Address of WorkStation
  126.     9) Logical Connection Number
  127.     
  128.     How it Works:
  129.     -------------
  130.     XMeter works by attaching a NetWare semaphore to a TSR in memory. It
  131.     requires that you have at least one TSR loaded. XMeter will now find
  132.     TSRs in high memory. In fact, XMeter searches high memory first.
  133.     
  134.     Since Netware semaphores are released when the connection is lost, XMeter
  135.     allows users to reboot their computer in the middle of an application
  136.     without having to run a cleanup utility to release the metered resource.
  137.     
  138.     Tricks:
  139.     -------
  140.     When XMETER creates semaphores, it adds the letters XM- to the front of
  141.     the semaphore name. So semaphore TEST is really XM-TEST. The idea here
  142.     is so that all XMETER semaphores can be indetified from other Netware
  143.     semaphores.
  144.     
  145.     Whenever a workstation first uses XMETER it creates a semaphore named
  146.     XM-XMETER. This can be used to see how many users are using XMETER
  147.     software. This semaphore can be cleared by using the command:
  148.     
  149.     XMETER XMETER/C
  150.     
  151.     If a user turns off their computer while running an application, Novell
  152.     will release their semaphores after 15 minutes. All semaphores are also
  153.     released when the user logs out. If a user reboots within 15 minutes,
  154.     the semaphores are cleared upon login.
  155.     
  156.     This software package is not the best program out there. It is designed
  157.     around being a simple "just works" solution to software metering. It is
  158.     flexable and uses no memory on the workstation.
  159.     
  160.     For more sophisticated software metering use MarxMenu.
  161.     
  162.     ==========================================================
  163.  
  164.         Make Check             Computer Tyme               Order Form
  165.         Payable To:     411 North Sherman Suite 300
  166.                          Springfield Mo. 65802 USA
  167.  
  168.                Voice: (417) 866-1222 * Sales: (800) 548-5353
  169.                  Fax: (417) 866-0135 * BBS: (417) 866-1665
  170.                Compuserve: 71333,427 * GO COMPTYME
  171.  
  172.         =============================================================
  173.  
  174.         Company:     ________________________________________________
  175.  
  176.         Name:        ________________________________________________
  177.  
  178.         Address:     ________________________________________________
  179.  
  180.         City/St/Zip: ________________________________________________
  181.  
  182.         Phone:       ________________________________________________
  183.  
  184.         PO. Number:  ________________________________________________
  185.  
  186.         Got From:    ________________________________________________
  187.  
  188.         Comments:    ________________________________________________
  189.  
  190.         Comments:    ________________________________________________
  191.  
  192.  
  193.         ==> XMETER * Version 1.71 * Release Date: 07-01-93
  194.  
  195.         ==> Price: $95/Server, $995/Unlimited
  196.  
  197.  
  198.         Dos ToolBox: $59.95/User __    MarxMenu: $59.95/User __
  199.  
  200.         Network Survival Kit: (Inc. ToolBox/MarxMenu) $495/Server __
  201.  
  202.         Shipping:     Ground: $3 __    2nd Day:  $6 __
  203.  
  204.                       1 Day: $15 __    Foreign: $15 __
  205.  
  206.         Credit Card Number: _______________ Expiration Date: ________
  207.  
  208.         Signature: __________________________________________________
  209.  
  210.                   Master Card: __   Visa: __   Discover: __
  211.  
  212.                     * We do not take American Express *
  213.  
  214.         =============================================================
  215.